MCP 문서 관리

메뉴

홈
문서 목록
관리자 로그인

문서 정보

최종 수정일:
2025-05-13 10:45
태그:
#MCP #써드파티 #검색 #AI

Perplexity MCP 서버

Perplexity MCP 서버

Perplexity MCP 서버는 Perplexity AI의 API를 활용해 웹 검색 기능을 제공하는 Model Context Protocol(MCP) 서버입니다. 이 서버를 통해 Claude Desktop과 같은 AI 어시스턴트가 MCP 생태계 내에서 최신 웹 정보를 검색하고 활용할 수 있습니다.

특징

  • 실시간 웹 검색: Perplexity의 Sonar API를 통해 최신 웹 정보에 접근합니다.
  • 인용 지원: 검색 결과에는 정보 출처가 포함됩니다.
  • 시간 필터링: 검색 결과를 시간대별(일, 주, 월, 년)로 필터링할 수 있습니다.
  • 다양한 검색 모드: 간단한 검색부터 심층 연구까지 다양한 검색 모드를 지원합니다.
  • 복잡성 자동 감지: 쿼리의 복잡성을 자동으로 감지하여 적절한 모델로 라우팅합니다.
  • 맞춤형 세부 수준: 간략, 일반, 상세와 같은 다양한 세부 수준으로 응답을 제공합니다.
  • 기술 문서 검색: 특정 기술, 라이브러리, API에 대한 문서와 사용 예시를 검색합니다.
  • API 통합: Perplexity AI의 강력한 검색 기능을 MCP 호환 애플리케이션에 통합합니다.

API

도구

여러 구현체가 존재하며, 일반적인 도구 구성은 다음과 같습니다:

search

기본 웹 검색을 수행합니다. - 입력: - query: 검색할 쿼리 - recency: (선택 사항) 결과 필터링 기간 ('day', 'week', 'month', 'year') - force_model: (선택 사항) 쿼리가 단순하더라도 특정 모델 강제 사용 여부

deep_research

복잡한 주제에 대한 심층적인 연구를 수행합니다. - 입력: - query: 연구할 주제 - focus_areas: (선택 사항) 집중할 특정 영역 배열 - force_model: (선택 사항) 쿼리가 단순하더라도 특정 모델 강제 사용 여부

get_documentation

특정 기술에 대한 문서를 검색합니다. - 입력: - technology: 문서화할 기술 이름 - detail_level: (선택 사항) 문서 세부 수준 ('brief', 'normal', 'detailed')

discover_apis

프로젝트에 통합할 수 있는 API를 발견하고 평가합니다. - 입력: - requirements: API 요구 사항 - include_pricing: (선택 사항) 가격 정보 포함 여부

analyze_code

코드의 오래된 기능이나 패턴을 분석하고 마이그레이션 가이드를 제공합니다. - 입력: - code: 분석할 코드 - target_version: (선택 사항) 마이그레이션 대상 버전

사용 방법

Perplexity MCP 서버를 사용하려면 다음 단계를 따르세요:

  1. Perplexity API 키 가져오기:
  2. Perplexity AI 계정을 만듭니다.

  3. 개발자 대시보드에서 API 키를 생성합니다.

  4. 설치 및 구성: 

    # NPX를 통한 설치 (가장 간단한 방법)
npx -y server-perplexity-ask

# 또는 uv를 사용하는 경우 (권장)
curl -LsSf https://astral.sh/uv/install.sh | sh  # macOS/Linux
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"  # Windows
uvx perplexity-mcp

  5. Claude Desktop 구성: 

    {
  "mcpServers": {
    "perplexity-ask": {
      "command": "npx",
      "args": [
        "-y",
        "server-perplexity-ask"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

  6. Docker를 사용한 구성 (선택 사항): 

    {
  "mcpServers": {
    "perplexity-ask": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PERPLEXITY_API_KEY",
        "mcp/perplexity-ask"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

  7. 또는 소스에서 빌드: 

    git clone https://github.com/ppl-ai/modelcontextprotocol
cd modelcontextprotocol
npm install
npm run build

환경 변수

  • PERPLEXITY_API_KEY (필수): Perplexity API 키
  • PERPLEXITY_MODEL (선택 사항): 사용할 Perplexity 모델 (기본값: "sonar")

서버 구현체

다양한 Perplexity MCP 서버 구현체가 존재하며, 각각 다른 기능을 제공합니다:

  1. 공식 Perplexity Ask 서버:
  2. 기본적인 웹 검색 기능에 집중

  3. GitHub: ppl-ai/modelcontextprotocol

  4. 확장 기능이 있는 Perplexity 서버:

  5. 쿼리 복잡성 감지 및 최적 모델 라우팅
  6. 다양한 연구 및 문서화 도구

  7. GitHub: DaInfernalCoder/perplexity-mcp

  8. 표준 웹 검색 서버:

  9. 간단한 웹 검색에 최적화
  10. 시간 필터링 지원

  11. GitHub: jsonallen/perplexity-mcp

  12. 연구 및 문서화 지원 서버:

  13. 기술 문서 검색 및 API 발견 기능
  14. 코드 분석 및 현대화 도구
  15. GitHub: pashpashpash/perplexity-mcp

사용 사례

Perplexity MCP 서버는 다음과 같은 상황에서 특히 유용합니다:

  1. 실시간 정보 검색: 최신 뉴스, 이벤트, 트렌드에 대한 정보를 검색합니다.
  2. 연구 및 학습: 복잡한 주제에 대한 심층 연구를 수행하고 다양한 정보 소스를 통합합니다.
  3. 기술 문서화: 개발자가 특정 기술, 라이브러리, API에 대한 문서와 사용 예시를 검색합니다.
  4. 코드 현대화: 오래된 코드를 분석하고 최신 모범 사례에 따라 업데이트합니다.
  5. 팩트 체킹: 정보의 정확성을 확인하고 신뢰할 수 있는 소스를 찾습니다.

문제 해결

  • "Failed to create client" 오류: Windows에서는 명령어 앞에 cmd /c를 추가해 보세요.
  • 도구가 보이지 않음: Claude Desktop의 망치 아이콘을 클릭하여 사용 가능한 도구 목록을 확인하세요.
  • API 키 인증 실패: API 키가 올바르게 구성되었는지 확인하세요.
  • 검색 결과 없음: 쿼리를 더 구체적으로 작성하거나 다른 검색어를 시도해 보세요.

연결된 구성 요소

참고 자료